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bout This Supplement 



This ProDOS 5upp/emef)f replaces Chapter 4 in the Appte He 
Owner's Manual. Not aH Apple He owners need to read it. 

Who Should Read II: Look ai the back cover of your Apple fie Owner's 
Manual. Find the part number in the lower-right comer, ir that part 
number Is 030-0356-A, 030-0356-B. or 030-0356-C, you need this 
Supplemsnt. Your Owner's Manuafv/as written with the DOS 3.3 
operating system tn mtnd, but you have the ProDOS^" operating 
system. 

If your Owner's Martuaf has any other part number, you can ignore this 
Sappiement. Your Owner's Manual was written with ProDOS in mind. 

If you plan to use both ProDOS and DOS 3.3, you wilt want to refer 
to both versions of Chapter 4. 

Your Owner's Manuai ^\\\\ refers to some terms that don't apply to 
you If you are using only ProDOS. When you see DOS 3.3. think 
ProDOS, The DOS 3.3 SYSTEM MASTER disk is equivalent to the 
ProDOS User's Disk. Ignore references to Integer BASIC. 
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'sing the ProDOS 
Operating System 



Introduction 



PfoDQS {rhymes with stow toss) is short 
for Professional Disk Operaling 
■Sysiem. 



This chapter describes the role of operating systems in general 
and introduces the ProDOS operating system. 

This chapter inciudes som« hands-on exercises that show you 
what an operating system does. It aiso introduces you to 
programming in Applesoft BAStC, 

You wili iearn how 

• to restart the connputer when the power is already on 

• to back up your ProDOS User's Disk by mailing a new copy of l\ 

• to see wtiat files are on a disk 

• to start a program running and then stop it 

• to format new disks 

• to understand error messages 

• to use Applesoft BASIC to do calculations 

• to write a simple program and save it on a disk. 



Did you notice thai most o1 an 
operating system's jabs have lo do with 
disks? The DOS in ProDOS stands for 
Disk OperaUng System. 



What an Operating System Does 

Afi Operating system is the software that organizes the 
computer's resources and makes them available to you and to 
application programs running on the computer. At your command, 
an operating system 

• copies programs, data fiies, and volumes (whole dtsl<s) 

• tells you what files are on a disl< 

• sends information to printers and other output devices 

• prepares disks (or use 

• stores (writes) information on disks 

• retrieves (reads) information from disks. 



Wtiat an Application Program Is 

Application programs work together with an operating system to 
iet you perform specific tasks. For example, a word processing 
program is an application program that lets you write, edit, file. 
and print reports, letters, and so on. Other application programs 
let you manipulate numbers, draw graphs, study French, play 
simulation games, and so on. 

Before you can run an application program, twwo things must 
happen: 

• First, you must load operating system software from a disk Into 
your computer's memory. 

• Second, you must load the application program itself into 

memory. 

The operating $ystem does not have to be ProDOS— it can, for 
example, be DOS 3.3 or Pascal— but it does have to be the same 
operating system for which the appHcation program is designed. 



In computer jargon, a slsriup cfisk is 
&QmaUnrtes called tt boot tUsK. and 

starting up a systeoi is sometimes 
called booting. This alludcrs to a systein 
puliing itseff up ty its bootstraps. 



What a Startup Disk Is 

In brief, a startup disk is one that contains both an operating 
system and one or more applfcation programs. Such a disk is 
called startup because it iets you load thte operating system, load 
an application program, and start tlie program running, simpty by 
putting the disk in the disk drive and turning on tlie power. 

When you buy an application program from your dealer, it Is 
usually on a startup disk, so you don't have to be concerned about 
the operating system. Follow the instructions that come with the 
program. Generally, you start such a program by simply putting the 
disk in disk drive 1 and turning on the power. 

Without any hardware modifications, your Apple Me can run startup 
disks that contain any of three operating systems: ProDOS, DOS 3.3, 
and Pascal. For ather operating systems, check with your dealer. 

The ProDOS User's Disk is a startup disk. It contains the ProDOS 
operating system (including utility programs). 



Non-Startup Disks 

Many Apple computer users create their own programs and trade 
them with friends and coworkers. Programs like these are usually 
stored on non-startup disks — disks that contain application 
programs but no operating system. 

Before you can run one of these programs, you must do two things: 

• Load the operating system for which the program was written. 
Remember, the ProDOS User's Dfsk contains the ProDOS 
operating system. 

• Load the application program itself from another disk. 
You'd learn more about this later. 




Hands- On Exercises 



If Ih* power is now ofl, pLit Ihe ProDOS 
User's Disk in drive 1 and use Ihe 
startup procedure described in section 
'-Starling Up (Booling) llie System" in 
Chapter 2 of the Owner's Manuai. 



By now, you're probably tired of reading about operating systems 
and eager to put one to work. Let's do iti 

Restarting the Computer When Power fs Already On 

This is the best way to restart your computer when the power is 
already on. This procedure works witli any startup disk. 



What You Do 



What Happens 



1, insert the ProDOS User's 
Disk in drive 1, and close the 
drive door. 



2. Press (d], then hold it down 
while pressing 

[CONTR 0L"|- [RESET] . 



3. Release (coNTROil- lRgsET ]. 



4. Release (dj)- 



The computer beeps at you, 
and the disk drive's light comes 
or>. The drive whirs and clicks 
while the information on the 
disk is read into (transferred to) 
the computer's memory. 

Then the drive's light goes out, 
and a startup display appears 
on the screen. 



It is possible to restart your computer by turning the power first 
off, then on again — but this causes unnecessary wear on the 
computer's power switch and circuitry 



The ProDOS Startup Display 

Every startup disk has its own startup display, and startup displays 
don't all look alike The display shown is the one you see when you 
either start up or restart the system with the ProDOS User's Disk 
in drive 1, 



*; * 

* PRODOS USER'S DISK * 

* *: 

* COPYRIGHT APPLE COMPUTER. IHC- 15S3 * 

YOUR OPTIONS ARE J 

'? - TUTOR: PRODOS E;--^:FLRNHT I ON 

F - FRCIDOS FILER (UTILITIES) 

- DOS <>> PRQDOS COHVER:=;ION 

S - DISPLfiV SLOT fiSSIGNHEHTS 

T - DESPLnV/SET TIME 

E - APPLESOFT BfiSIC 

PLERSE SELECT ONE OF THE nSO^E 53S 



Backing Up Your PrcDOS User's Disk 

You should make copies of important disks like your ProDOS 
Users Disk. Then, if a disk is damaged, you have not lost its 
contents. This is called backing up your disk^. 

By the Way: Soma application disks that you buy from a dealer may be 
copy-protected. This means mat you can't make your own backup 
copies of these disks. However, such programs are often sold with a 
backup disk in Ihe package. 



When you copy a dfsk, you need to know the number of the slot 
where your disk controller card is located. If you know where it is. 
skip the neict three steps. If you don't remember, this tells you 
where it is. 



What You Do 



What Happens 



1. With the ProDOS startup 
display on the screen, press 



This selects the DISPLflV 
SLOT RiSIGKNENTS 
option. 



2, When theDISPLRV SLGT 
flSSIGNMEHTS display 
appears on the screen, notice 
the slot location o1 the disk 
drive controller card. This is the 
number ot the slot where your 
disk controller card is located. 



In the illustration, the disk 
controller card is in SLOT 6, 



***:4; :+:.*.:*.■*: ?.?:*::?: "4^ :+::*: 4-+*^ + A-t. ******** *** + *+-*i* 

* * 

* DISPLRV SLOT RSSIGHMENT3 * 

* * 
***** 4:**************** **************** 

STHRTUP DISK! .'USER' S.DISK^ 

YOUR Apple ^ HR:? i 

e4R OF RftNDOM fiCCESS MEMORY 

APPLESOFT IN ROM 



SLOT 1 
SLOT Z 
SLOT 3 
SLOT 4 
SLOT 5 
SLOT 6 
SLOT 7 



EtIPTV 

E'tlPTY 

g.0-COLiJriH. Cl^RD 

EMPTY 

EMPTY 

DISK DRIVE 

EMPTY 



PRES? RETURH TQ DISPLAY HfllM HEHU 



3- Press [return). 



This takes you back to the 
ProDOS startup display. 



Here's how to make a backup copy of the ProDOS User's Dfsk: 



What You Do 



What Happens 



r With the ProDOS startup 
display on the screen, press 

(E- 



This selects the ProDOS Filer, 
The disk drive whirs for a 
moment. 



2. When the Fil^r menu 
appears on the screen, press 



3. When the '...'ijLUME 
cnrlMHi-iLf:=i menu appears. 
press [cj. 



This selects './CLUhE 
cnnriRNDS^ operations on 
whole disks. 



This selects the i. OPV R 
vCiLiJhil process. The program 
lirst asks for ttie slot number of 
your disk controller card. 



-COPY- 

THE UOLUME IH 3LGT 



L 6J 



4, If your disk controller card is 
in slot 6. press [re turn J , It it Is 
in some other slot, type the slot 
number over b. 



The cursor moves down to the 
next line, asking you for the 
number of the disk drive (there 
can be two drives connected to 
each controller card). 



-COPY- 

THE UOLUME 



IN SLOT: 



<6> 



5. Because your ProDOS 
User's Disk is already In drive 1, 
press (IeturnJ. 



The cursor moves down again, 
to ask you for the slot and drive 
numbers of the blank disk 
where you want the ProDOS 
User's Disk to be copied- 



-COPY- 

THE VOLUME IM SLOT; C 6 ? 

DRIVE! C,l> 

TO '.JOLUME IN SLOT: C6) 

DRIVE: C£> 

MEW VOLUME MPME: 



6. Indicate the slot and drive 
numbers as before, and press 

[RETURN) . 



A message appears at the 
bottom of the screen. If you 
have two disk drives, It Is 

"INSERT DISKS FiHD 
P R E S S < R E T > - . If you h^a ve 
only one drive, 11 is -INSERT 
SOURCE DISK HHD 
PRESS <RET>-- 



7, If you have only one drive, 
leave the ProDOS User's Disk in 
the drive. 



The program wtll let you know 
when to put the blank disk into 
drive 2 . 



8, Press (return K 



The cursor moves up to the 
center of the screen, and the 
program asks what name you 
want to give the new disk. 



-COPV- 

THE VOLUME IN SLOT i 
DRH-'E : 




TU '.JULUME IK SLOT 1 
DRI^E : 


<2> 


NEW VOLUME NfinEi < 


IxFK-^.DlSK > 



9, In the space between the 
parentheses, type 
FRGDOS , EiRCKUP and then 
press (RETURN ! ■ If you type any 
improper characters, the 
program ignores them and 
beeps at you in warning. 



The name you type within the 
parentheses overrides the 
name that was there. 



10. The Filer program asks 
whether it's all right to 
overwrite the former contents 
of the disk. 

If It's all right, press (T]. 

If It's not all right, press (n] 
and go back to step 4. 



If the destination disk is r>ot 
blank — if it contains old 
information — you see the 

message DESTROY 
'■'..'OLLtME h[P!f1E"?'::Y..^-H) 
If the destination disk is 
blank, the message is 

D E S T R ij Y M D W -PR G DO S 



11. If your source disk (the disk 
you are copying from) and the 
destination disk are in two 
different drives, they can stay 
where they are throughout the 
COPY R MOLUnE process. 

If you have only one disic drive, 
you must follow the instructions 
that appear on the screen — 
removing the source disk and 
inserting the destination disk, 
then doing the reverse, until the 
CO FY R '^.'QLUMI^ process is 
complete. 



12, When the copying is 
complete, you see the message 

CuF'V CuMr LL FE. The UGRV 
f\ '..'OLUME display remains on 
the screen. 



The program formats the 

destination disk before starting 
the copy. 



This returns you to the ProDOS 
startup display. 



Press [ ESC I twice, press jo] , 
and press [return]. 



13. Remove the new backup 
ProDOS User's Disk and label 
it. Use a felt-tip pen to protect 
the disk from damage. 



You now have two copfes of the ProDOS User's Disk. Keep one of 
them in a sate place, as a backup. 




A file is a colleclion ol related 
information, with its own filename. 
stored an a disk or otiier storage 
device. 

The catalog is Kke a table of contents 
far tlie disk. II lists inrormation about 
each fil6 on the disk. 



You're in Applesoft BASIC when the 1 
prompt character is displayed, ^_ 

The disks nfoJume oame.- 

The name of the file or program,- 

The amount of disk space thjs file 
occupies, expressed in blocks. The 
bottom imeof the display indicates the 
total number of BLiJCKS FREE and the 
number of E^LOCKS USED. 



The date when the file was rrtost 

recently MGDIF I Ei3- 



Seeing What's on a Disk 

Whenever ProDOS stores Information on a disk— whether that 
information is a program, a iist of telephone numbers, or a 
report — It stores the Information as a file, under the name you 
give it. The names and locations of all files on a disk are stored in a 
special disk area that ProDOS calls the catalog^ 

Here s how to get a ProDOS disk's catalog onto the screen, where 
you can read it: 



What You Do 



What Happens 



1. If youVe not already in 
Applesoft BASIC, choose 
option 8 from the ProDOS Main 
Menu. 



3 and a cursor appear on the 
screen. 



2. Type i!;RT and press 

fRETURN). 



The catalog appears on the 
display. It should resemble the 
one Illustrated. 



. /USERS. OISK 
MPrtE 



TYPE BLOCKS /lODIFIED 



'*PR0DD5 SYS 

*ERSIC , SYSTEM SYS 

*COHWERT SYS 

^FTLER SYS 

*STHRTLIP BflS 

BLOCKS FREE: 1 1? 



51 
24 



•l-DEC-e3 
1-DEC-S3 
:-DEC-i53 
l-DEC-93 
1-DEC-'S3 



BLOCKS USED i 



1 63 



File Protection 

ff the disk's catalog shows an asterisk (t) tp the left of a filename, 
that file is locked. You can't accidentally change or overwrite a 
locked file. If there Is no asterisk, the file is not locked. 



Warning 

Being locked does not protect a file fronri being erased by the COPV fi 
WOL-JIIE process. To protect an entire volume {entire dfsk) from, being 
overwrftten. cover the write-enabte notch, if there is no write-enable notch 
in the side of the disk's jacket, the disk is permanently write-prolected. 



To unlock, for example, a lile named HYPNOSIS, type after the 1 
prompt 

UHLGuK HYPNOSIS 

To confirm that HYPNOSES has really been unlocked, use the CAT 
command to see that the name HYPNOSIS is not preceded by an 
asterisk. 

To lock HYPM03IS. simply type LOCK HrPHilSTS. 



Running a Program Stored on a Disk 

The ProDOS User's Disk contains some application programs you 
can run right now. With Applesoft's J prompt character displayed. 
type "I Fit, and press (return) . 

When the disk's catalog appears, look at the program names and 
file types. 

By the Way: You can run a tile even If it's locked— you Just can't change 
or deiete it. 

Here's how to run any program that has the file type BAS [for 
BASIC): 



What You Do 



1, Type RLiN followed by a 
space and the program name. 

2. Press (return] . 



What Happens 



Jt takes a few seconds for your 
computer to find. load, and 
start the program. 




3. Follow the Instructions, if 
any. that appear on the screen. 



4, To stop a running program, 
see the instructions in the next 
section. 



Stopping a Running Program 

Suppose you want to stop a program while it's in progress. 
Programs usually teil you how, but if one doesn't, you can still exit 
from a program at any lime. This section describes six mettiods. 
Try number 1 first, and go down the list until you find one 
that works. 



What You Do 



What Happens 



1. Press [esc]. 



Some programs use this key to 
let you escape. 



2, Press [control] -[p], (While 
holding down (control), press 



To some programs, 

( CONTROL J -Cc^] means cancel. 



3. Press [controlJ -Cc] and 

then [FtETURNT 



Some programs don't get the 
flint unless you reinforce It! 



4. Press [contbolI - Ireset] . 



Th« program stops or returns 
to its opening menu and. in 
nnost cases, remains in 
memory, unharmed. 



5. While holding down [a), 
press and then release 

(control |- [RESETi . 



This is the restart procedure 
discussed earlier In this 
chapter It is a pretty drastic 
way to stop a program — it 
clears the computer's memory, 
destroying any work you have 
there. 



6. Turn olf the power, then 
restart the computer. 



You will rarety have to go this 
far to stop a program. But it 
shows the computer who's 
boss. This method also dears 
memory. 




To formal a disk means to erase any 
(nlormation on i1 and prepare i| for use 
with a particular operating system. 



FormBtting a New Disk 

When yoL buy blank disks, they have nothing recorded on them — 
just like blank tape tor a tape recorder. Before a disk can receive 
information from ProDOS, you must lormat it. 

If you keep on hand a supply of disks formatted by ProDOS, or by 
any other operating systems you might use^ you never have to 
interrupt your work to format a disk. 



The Filer, among other things, formats disks. 

By the Way: You don't have to Format a disk if youVe going to copy the 
contents of another disk to it. The CijPV R '■/OLIJME function of the 
ProDOS Filer program automatically formats the destination disk 
before it begins a copy operation. 



What You Do 



What Happens 



1, To get the Filer's menu on 
the screen, do one of the 
following: 



If Applesoft's J prompt is not 
on the screen, put the ProDOS 
User's Disk In drive 1 and start 
up the system as described 
earlier in this chapter. When the 
ProOOS startup display 
appears, press [F], 



The Filer's menu appears on 
the screen. 



If J is on the screen, type 



-FILER and press [return] . 



The Filer's menu appears on 
the screen. 




% t 

t RPPLE'? PRODOS SySTEM UTILITIES * 

t * 

*. FILER VERSION 1,6 * 

* COPYRIGHT n'F'PLE COMPUTER,, INC., 1983 * 

" - TUTOR 
F - P ILE COMMRNDS 
*J - l-'iULUtlE CONNRNDS 
D - CONFIGURflTION DEFRULTS 
C! - OUIT 
PLERSE SELECT AM OPTION; S 



2. Press (V) to select '...'OLUME Soon the '...lOLUME 

CuMHhNDS. Cut'U-lflNDS menu appears. 



t ^;'DLUME COMMANDS * 
* * 


■-• 


~ TUTOR 


F 


- FQPMflr fi VOLUME 


i'" 


- COPY fi '.VOLUME 


L 


- LIST VOLUMES 


R 


- RENRME ft VQLUMe 





- DETECT BAD BLOCKS 


B 


- BLOCK RLLOCFITION 


K 


- COMPRRE VOLUMES 


SELECT AN OPTION OR <ESC> : IS 




3. Press (T) to choose the 

FORKia'T R '...'GLUME option. 



TheFijPrlliT H VilLUflE 
display now appears^ a$i<lng 
you for a siot and drive number. 
The Filer wants to know exactly 
where to find tiie disk that is to 
be formatted. 



« FDI^MfiT fl VOLUME * 

* * 

*************:^*******i*:*** *************** 



-FGRMfiT- 

THE V/QLUriE IH SLOT I 



(6) 



NEW VOLUME NAME i 



4. Put the disk volume you want 
to format into any available disk 
drive. If you have only one disk 
drive, that means taking the 
ProDOS User's Disk out of the 
drive and replacing it with the 
disk you want to format 



5. Complete the steps in 

FORMAT R UOLLiriE in much 
tfie same way you completed 
those in CO F'Y h '...'ulume. 



As soon as you specify the slot 
and drive of the disk to be 
formatted, the program asks 
what you want to name the disk 
you're about to formal. 



KEU VOLUME NfiME; t/ELFlNKh^h 



By the Way: If you ever fed unsure of yourself while you're usEng the 
Filer, just press (ESC) until you're on familiar ground. 



6. Later in this chapter, you'll 
need to save an Applesoft 
program on a disk. With this In 
mind, name this disk 
PROGRAMS and press 
(returnI . 




7. If the d^sk to be formatted is 
blank, formatting begins. 

If the disk to be formatted is not 
blank (if it already contains 
information), the program asks 
DESTROY '\---ijLD , '...'QLUriE . 
MliriE"? '::V.--^H>H. If you're 
sure it's all right to destroy the 
old information on the disk, 
press i'Y]. If you've mistakenly 
put the wrong disk in the drive, 
and you don't want to destroy 
its contents, press [n] ^^^ QO 
back to step 4. 



When formatting is complete. 
the message FuPHhT 
COnPLETE appears on the 
screen. 



8, Press (esc) twice, press [o], 
and press Ireturn), 



This returns you to the ProDOS 
startup display. 



9. Remove the newly formatted 
disk from the drive and use a 
felt-lip pen to write the new 
volume name on the disk label 
Remember that pencils and 
ball-point pens can damage the 
disk! 



Using Applesoft BASIC 

The ProDOS operating system works hand in hand with the 
Applesoft BASIC programming language. 



Selecting BASfC 

Applesoft BASIC is one of the options that can be selected from 
the ProDOS startup display. 

What You Do What Happens 



With the ProDOS startup 
display on the screen, press 

CD- 



The Applesoft display appears. 
Applesoft's prompt character 
(]) is a cue that Applesoft is 
waiting for your instructions. To 
the right of the prompt is the 
cursor. 



i 



PRODOS 


1 , 9 COPYRIGHT RPPLE. 

TO RETURN TO MENU, TYPE 

■r?UN STARTUP' 
AND PRESS RETURN. 


I3s:? 


:m 







Some BASIC Basics 

In this section, you'll learn a little bit about error messages. 



What You Do 



What Happens 



1. If you haven't already done 
so, either start up or restart the 
system with the ProDOS User's 
Disk in drive 1, and press (¥) 
to select Applesoft BASIC. 



2, Lock [caps LOCK) In the down 
position^ type Hull, and press 

[HETUftN] . 



The computer beeps at you and 
displays the message 

?SVNTR>: ERROR 



because neither Applesoft nor 
ProDOS recognizes Hui'i as a 
valid command. 




3, Now type HOhtE and press 



[RETURN 



This time, Applesoft 
understands your command — it 
clears the screen and moves 
the cursor to the upper-ieft 
corner of the screen (the home 
position). 



You wiil probably see the 
message SYHTRI^! ERROR now 
and tlien. \t simply means tliat a 
program couidn't make sens© 
out of what you typed. It usualiy 
means you misspelled a 
command or accidentally 
pressed the wrong key while 
typing a command. 



By the Way: ProDOS commandsH tliose that tell the computer to do 
something with a disk, can be either uppercase or lowercase 
characters. Some versions of Applesoft require that commands be 
uppercase. To be sure, it's a good idea to type all commands in 
uppercase. 

Calculating With Apptesott BASIC 

Did you know that your Apple II is a calculator? Of course, it*s 
much more than that, but this exercise shows you one of a 
computer's most basic applications. 

If you're already an experienced programmer, skip to "Where to 
Learn More" laler in this chapter. 

The exercises in the next two sections don't require ProDOS. In tact, 
you can do them even if you have no disk drive. 



^Q 



What You DQ 



1. With Applesoft's II on the 
screen, type 



PRINT 



!+2 



What Happens 



The solution. 4, appears 
Immediately, 



and press [ return ] . 



2. Try some more calculations. 
Use - for subtraction, t for 
multiplication, and for 
division. Use the period ( . ) for 
the decimal point. Just 
remember to begm each 
problem with Phil NT and end it 
with (r eturn ) ■ 



3. Try something more 
complex, such aa 

PRINT 345+99-43'Z'. 



The answer is 9. 



Writing a Simple Program 

Maybe you're rot going to be a programmer, but this gives you a 
taste of il. With Applesoft's 1 displayed, you're ready to go. 



What You Do 



What Happens 



1. After the 1. typeHElLJ and 
press [return]- 



This clears the computer's 
memory, making It ready to 
receive your program. 



2. Lock (capslock) down. 



This helps you avoid the 
message ■"■SVNTRX ERROR. 



3, Type 10 PRINT "WHRT UJ is a line number. Eactt 

IS YCUR HfiMEV" and press instruction in an Applesoft 
fRETURN) . program must have a tine 

number. This tells Applesoft In 
what order you wanl it to 
perform the instructions. You 
can type instructions in any 
order H's good practice to 
number lines li^, Jjm, and so 
forth, to leave room for adding 
lines later. 



L 




To enlflf a pifogr&m means to use the 
keyboard to send It to tfte computer s 
temporary memory. 

A pTonram is a series of detailed 
instructions Ihat tell the computer how 
to accomplish a specific task. 

To run a program, means to cause it to 
perform the Instructions you entered. 



4. Type Ski INPUT NRME$ 
and press [return). 



The word INPUT tells 
Applesoft to expect something 
called NAME to be typed at the 
keyboard. The i- means that 
when you use the program, 
you're going to type text, as 
opposed to numeric data. 



5. Type 

31-3 PRINT ^'HELLO, " .: 
NRriE$ 

and press Ireturn) . 



This program line tells 
Applesoft todispiay HELLO., 
and the name that you type in 
response to program line 20, 

You Just entered a three-iine 
program into the computer's 

memory. 



6. To run your program, typ© 

RLfLL 



7. When the program a$ksyou 
for your name, type it next to 

the "i^ prompt and press 

[RETURN 1 . 



Dobs the program do what you expected? If it did, congratulations! 
That's programming! if not. start again by typing MEN and be sure 

to type every character exactly as shown. 

Now you know how application programs learn your name and tafk to 
you in a personal wayl 




Modifying Your Program 

To insert lines in a BASIC program, just type new lines that 
with line numbers that you haven't already used. 



in 



What You Do 



What Happens 



1* With your program still in 
memory, type j hJtlE and 
press [return). 



2. Type z'^ HOME and press 



RETURN 



Two new tines (numbered 
5 and 25) are inserted into your 
program. They cause the 
display to clear before each 
message is printed. 



3. To see what effect your 
changes have on the program's 
operation, type PUhl and press 

[return] . 



You modified a program by 
inserting new lines. 



Saving Your Program 

Now that you're the author of a program, you need to know how to 
save that program on a disk. You can use the disk that you 
formatted earlier in these exercises. 



What You Do 



What Happens 



1. Put your formatted blank 
disk named PROGRAMS in 
drive 1. 



2. Type 

SfiUE MVFIRSTPROGRRM, 
Dl 

and press [return). 



3. To confirm that your 
program is now on the disk, 
type 

CRT ,,Dl 



MVFIPSTF'RijGRRM is your 
program's filename, Dl 
indicates disk drive 1. The disk 
drive hums for a moment while 
your program is written (copied) 
from memory onto the disk. 



The disk's catalog appears on 
the display. 



and press [ReTURN] . 



i 



M 



. PR-GGRfiMS 

NflriE TYPE BLOCKS MODIFIED 

HYFIRSTPROGRRH BRS 1 <NG DFiTE> 

BLOCKS FREE: 272 BLOCKS USED; S 



Where to Learn More 



You've now had a taste of BASIC programming, and you've used 
some of the most important ProDOS procedures. 

To learn more about programming, use the Apptespft JutvnaL 

To learn more about ProDOS, see the ProDOS User's Manual. 



If You Have a Problem 



This section hefps you if your computer system doesn't work 
quite right. 



Disks That Don't Seem to Work 

Sooner or later you will come across a disl< that just doesn't seem 
to work. 

• A faulty or blank disk might just spin, causing an even whirring 
sound when you try to start up the system with it or try to load a 
program from it. 

• Non-startup disks formatted by an operating system other than 
the one currently in the computer's memory can cause the drive 
to clack away noisily. 



In eittier case, press [coNTROLj-(nESEt] (you may have to do this 
more than once). After about a second, the disk drive stops. 
Remove the disk that causes the problem, and replace it with 
another. 




Some Error Messages 

Just about every program has error messages ^hat appear on the 
screen when you nnake a mistake. Don't panic. If you get yourself 
into a real mess, you can always restart the system and begin 
anew. 

Error messages can come either from ProDOS or (rom Applesoft. 

• The message SVNTRX ERROR comes from ProDOS. 

• The message '?c:t'NTR>:^ ERROR comes from Applesoft, 

For a complete explanation of all ProDOS error messages, see the 
ProDOS User's Manual. For a complete explanation of all 
Applesoft error messages, see the Appf&soft Tutoriafox the 
Applesoft BASIC Programmer's Reference Manual. 

Here are some of the error messages you may encounters 

FILE LOCKED 

This message appears when you try to store information in a 
locked file. To unlock a file named TESTDATA, type Ui^LOCK 
TESTDRTfi and press (pItOrn]. 

FILE TYPE MlSmTCH. 

Certain commands work only with certain file types. For exampte, 
the RUN command works with BAS (BASIC) files, but not with SYS 
(system) f*les. This message indicates that you tried to use an 
inappropriate combination of command and file type. To 
determine a fJle's type, use the CAT command. 




I..-0 ERROR 

This can mean there is a poor connection between the computer 
and the disk drive or a printer, that a d[sl< is not properly aligned, 
thai there is no dtsk in the drive, Of that the disk drive door is not 
cfosed- If there is no disk in the drive, insert one. If the drive door is 
open, c!ose It. If there is a disk in the drive, remove the disk, 
replace it in ttie drive, and close the drive door. If none of these 
things helps, check the connections between the disk drive cable 
and the disk controller card, and between the disk controller card 
and its slot. 

SVhTRX ERROR 

To a computer, syntax has to do with the way words and 
statements are used together and how they are spelled. The most 
common cause of a SYi-iTiiX ERROR message Is a typing mistake. 

WPITE-PROTECTED 

You see this message if you try to copy data onto a write-protected 
disk. A write-protected disk is one that either has no write-enable 
notch on its right edge, or has a covered wrfte-enable notch. 

As lor>g as a disk is write-protected, none of its files can be 
modified, added to. or removed. This is an important and useful 
feature. U prevents you from accidentally writing over important 
information or valuable programs. Software that you buy from your 
dealer Is almost always supplied on write-protected disks 

To remove write-protection from a disk that has a covered write- 
enable notch, remove the tape that covers the notch. 
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